home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / msdos / viewers / disp160 / read.me < prev    next >
Text File  |  1993-12-03  |  14KB  |  393 lines
  1. ******   You can distribute this program freely for non-commercial use.
  2. ******   There is no warranty. The author is not responsible for any
  3.          damage caused by this program.
  4.  
  5.  
  6. (1) Introduction:
  7.   This program can let you READ, WRITE and DISPLAY images/movies with different
  8.     formats. It also let you do some special effects(rotation, dithering ...)
  9.     on image. 
  10.   Features:
  11.     Include simple file management system.
  12.     Support 'slide show'.
  13.     Support 'batch conversion'.
  14.     There is NO LIMIT on image size.
  15.     This program supports 8, 15, 16, 24 bits display.
  16.     Support movie files(DL,FLI/FLC,RAW,MPEG,AVI).
  17.     Support mouse.
  18.     Support contact sheet making.
  19.  
  20.   The official site is NCTUCCCA.edu.tw:/PC/graphics/disp.
  21.   IP address is 140.111.1.10 or 192.83.166.10
  22.  
  23. (2) Hardware Requirement:
  24.   PC 386 or better. MSDOS 3.3 or higher.
  25.   I recommend min 8M bytes for better performance.
  26.   Hard disk for swapping(virtual memory).
  27.  
  28.   The following description is borrowed from DJGPP.
  29.  
  30.   Supported Wares:
  31.  
  32.   * Up to 128M of extended memory (expanded under VCPI)
  33.   * Up to 128M of disk space used for swapping
  34.   * SuperVGA 256-color mode up to 1024x768
  35.   * 80387
  36.   * XMS & VDISK memory allocation strategies
  37.   * VCPI programs, such as QEMM, DESQview, and 386MAX
  38.  
  39.   Unsupported:
  40.  
  41.   * DPMI (Although go32 support DMPI. DISPLAY can't run under DPMI)
  42.   * Microsoft Windows
  43.  
  44.   Features: 80387 emulator, 32-bit unix-ish environment, flat memory
  45.   model, SVGA graphics.
  46.  
  47.  
  48. (3) Installation:
  49.  
  50.   Video drivers, emu387 and go32.exe are borrowed from DJGPP.
  51.   This go32.exe(from DJGPP 1.10) is a modified version.
  52.  
  53.   *** If this go32.exe is not compatible with other DJGPP program
  54.       in your system, DON'T put go32.exe within search path.
  55.  
  56.   *** Please use RUNME.BAT to run this program.
  57.   *** Please use text editor to modify the configuration file, CONFIG.DIS.
  58.  
  59.   If you choose xxxxx.grn as video driver. add 'driver xxxxx.grn' to GO32.
  60.     For example, go32=driver x:/xxxxx/xxxxx.grn
  61.  
  62.   If you don't have 80x87, add 'emu x:/xxxxx/emu387' to environment GO32.
  63.     For example, go32=driver x:/xxxxx/xxxxx.grd emu x:/xxxxx/emu387
  64.  
  65.   If you use VESANEW.GRN, there are three options for you :(These three
  66.        options have no effect on other video drivers)
  67.     'real' : Do bank switching in real mode (Recommended).
  68.     'prot' : Do bank switching in protected mode.
  69.     'none' : Let DISPLAY do bank switching for you (Always work).
  70.  
  71.     For example, go32=real driver ............
  72.  
  73.   If your memory manager supports DPMI, then you must add 'nodpmi' to GO32.
  74.  
  75.   If you have video card with more than 1M bytes memory, add 'lvram' to GO32.
  76.  
  77.   Notes: 
  78.     1. I only test tr8900.grn, et4000.grn and vesanew.grn. Other drivers are 
  79.          not tested.
  80.     2. I have modified et4000.grn to support 8, 15, 16, 24 bits display. You 
  81.          don't need to use vesa driver.
  82.        If et4000.grn doesn't work, please try vesanew.grn.
  83.     3. For those who want to use HiColor or TrueColor display,
  84.        please use vesanew.grn(except et4000 users).
  85.        You can find vesa BIOS driver from :
  86.          wuarchive.wustl.edu: /mirrors/msdos/graphics
  87.          godzilla.cgl.rmit.oz.au: /kjb/MGL
  88.  
  89.  
  90. (4) Command Line Switch:
  91.  
  92.     Usage : 
  93.       display [-d|--display initial_display_type] [-s|--sort sort_method]
  94.               [-f config_file] [-a] [--slide] [-n l|g] [-h|-?] 
  95.               [image_file(s) | @response_file]
  96.  
  97.       for command-line batch conversion :
  98.         display (--batch | -b) output_format [--bw|--grey|--color|--true]
  99.                 [--dialog | -g]
  100.                 (file | file dir | file1 file2 | files dir)
  101.  
  102.     Display type: 8(SVGA,default), 15, 16(HiColor), 24(TrueColor)
  103.     Sort method: 'name', 'ext'
  104.     -a: Always set to highest display type
  105.     -f: Read user specified config file only.
  106.     -n: Don't read Local or Global config file.
  107.     --slide: Do slide show for listed file(s).
  108.     output_format : Standard extensions. Like gif, bmp ... (see section (7))
  109.     default color type for batch conversion is Full color(8 bits).
  110.  
  111.  
  112. (5) Function Key:
  113.  
  114.     F1 : Print READ.ME.
  115.  
  116.     F9 : For those who can't remember all commands of DISPLAY.
  117.  
  118.     F2 : Change disk drive.
  119.  
  120.     CTRL-A -- CTRL-Z : change disk drive.
  121.  
  122.     F3 : Change filename mask. (See match.doc)
  123.  
  124.     F4 : Change parameters.
  125.  
  126.     F5 : Some effects on picture, eg. flip, rotate ....
  127.  
  128.     F7 : Make Directory.
  129.  
  130.     t,T : Tag file.(Can untag tagged files)
  131.  
  132.     + : Tag group files. (See match.doc)
  133.         When image is shown, '+' can change to next resolution.     
  134.  
  135.     ALT-T : Tag all files.
  136.  
  137.     u,U : Untag file.
  138.  
  139.     - : Untag group files. (See match.doc)
  140.         When image is shown, '-' can change to previuos resolution.
  141.  
  142.     ALT-U : Untag all files.
  143.  
  144.     Ins : Change display type (8,15,16,24).
  145.  
  146.     F6,m,M : Move file(s).
  147.  
  148.     ALT-M : Move single file(ignore tag).
  149.  
  150.     F8,d,D : Delete file(s).
  151.  
  152.     ALT-D : Delete single file(ignore tag).
  153.  
  154.     r,R : Rename file.
  155.  
  156.     c,C : Copy File(s).
  157.  
  158.     ALT-C : Copy single file(ignore tag).
  159.  
  160.     z,Z : Display first 10 bytes in Ascii, Hex and Dec modes.
  161.  
  162.     f,F : Display disk free space.
  163.  
  164.     Page Up/Down : Move one page.
  165.  
  166.     TAB : Change processing target.
  167.  
  168.     Arrow keys, Home, End, Page Up, Page Down: Scroll image.
  169.       Home: Left Most.
  170.       End: Right Most.
  171.       Page Up: Top Most.
  172.       Page Down: Bottom Most.
  173.       in 'screen' & 'effect' menu :
  174.         Left,Right arrow: Change display type(8, 15, 16, 24 bits).
  175.  
  176.     CTRL-Arrow keys : Crop image by one line(in graphics mode).
  177.     CTRL-SHIFT-Arrow keys : Big Crop.(Controlled by 'big_crop_step').
  178.  
  179.     s,S : Slide Show(show tagged files). ESCAPE to terminate.
  180.  
  181.     b,B : Batch conversion(convert tagged files to single format).
  182.           You can perform up to 8 special operations.
  183.           Each is independent of others.
  184.  
  185.     e,E : Contact sheet making.
  186.  
  187.     w,W : Wait/Pause in slide show.
  188.  
  189.     q,Q : Accumulation color quantization.
  190.             Find a best palette set for group of files.
  191.             Very useful for producing animation pictures.
  192.  
  193.     l,L : List available graphic/text modes.
  194.  
  195.     o,O : Display font.
  196.  
  197.     ALT-X : Quit program without prompting.
  198.  
  199.     ALT-A : Reread directory.
  200.  
  201.     ALT-S : Save config file.
  202.  
  203.     0..9 :
  204.     SHIFT-A..Z : Jump to first file whose name starts with this character.
  205.  
  206.     F1 .. F8 : Gamma correction in graphic mode.
  207.       F1,F3,F5,F7: decrease Red,Green,Blue,All.
  208.       F2,F4,F6,F8: increase Red,Green,Blue,All.
  209.  
  210.     F9,F10 : Zoom Out/In in graphic mode.
  211.  
  212.     BACKSPACE : Go up one level of directory tree.
  213.  
  214.     Escape : Abort function and return.
  215.  
  216.  
  217. (6) Mouse Buttons:
  218.  
  219.     MIDDLE button and CTRL-RIGHT button always mean ESCAPE. 
  220.  
  221.    in read/write menu:
  222.      single-click LEFT or RIGHT button = 'move select bar'.
  223.      double-click LEFT button = RETURN.
  224.      double-click RIGHT button = SPACE.
  225.      CTRL-LEFT button = Tag.
  226.  
  227.    in other text menus:
  228.      RIGHT button means SPACE.
  229.      single-click LEFT button = 'move select bar'.
  230.      double-click LEFT button = RETURN.
  231.  
  232.    in contact sheet preview:
  233.      RIGHT = show/hide mouse cursor.
  234.      LEFT = if (mouse cursor shown) move contact sheet.
  235.             else leave graphic mode. 
  236.      CTRL-LEFT = move image piece.
  237.  
  238.    in image display screen:
  239.      RIGHT = show/hide mouse cursor.
  240.      LEFT = if (mouse cursor shown) move image around screen.
  241.             else leave graphic mode.
  242.      CTRL-LEFT = move one page.
  243.      SHIFT-LEFT = show information box. 
  244.        You can move this box around screen by click and drag.
  245.  
  246.    In some text regions the mouse cursor will change. Press LEFT button
  247.    to do that function.
  248.  
  249.  
  250. (7) Support Format:
  251.  
  252. + Read: GIF(.gif), Japan MAG(.mag), Japan PIC(.jpc), Sun Raster(.ras),
  253.         Jpeg(.jpg), XBM(.xbm), Utah RLE(.rle), PBM(.pbm), PGM(.pgm),
  254.         PPM(.ppm), PM(.pm), PCX(.pcx), Japan MKI(.mki), Tiff(.tif),
  255.         Targa(.tga), XPM(.xpm), Mac Paint(.mac), GEM/IMG(.img),
  256.         IFF/ILBM(.iff,.lbm), Window BMP(.bmp), QRT ray tracing(.qrt),
  257.         Mac PICT(.pct), VIS(.vis), PDS(.pds), VIKING(.vik), VICAR(.vic),
  258.         FITS(.fit), Usenix FACE(.fac), IRIS(.sgi), YUV(.yuv), RAW,
  259. +       PCPAINT/Pictor(.pic,.clp).
  260.  
  261.         DL(.dl), FLI(.fli), FLC(.flc), RAW(.raw, produced by DMPEG),
  262. +       MPEG(.mpg), AVI(.avi), GL(.gl).
  263.  
  264.         the extensions in () are standard extensions.
  265.  
  266.   Write: GIF, Sun Raster, Jpeg, XBM, PBM, PGM, PPM, PM, Tiff, Targa,
  267.          XPM, Mac Paint, Ascii, Laser Jet, IFF/ILBM, Window BMP,
  268.          Mac PICT, VIS, FITS, FACE, PCX, GEM/IMG, IRIS, YUV, RAW.
  269.  
  270.   All Read/Write support full color(8 bits), grey scale, b/w dither,
  271.       and 24 bits image, if allowed for that format.
  272.  
  273.  
  274. (8) Detail:
  275.  
  276.    Initialization:
  277.       Set default display type to highest display type.
  278.       Find allowable screen resolution(for .grn video driver only).
  279.       Read configuration file(Global and Local).
  280.         Global: where DISPLAY.EXE stays. Local: Where you are.
  281.       Process command line options.
  282.  
  283.    1. When you run this program, you will enter 'read' menu. Whthin this
  284.       menu you can press any function key. If you move or copy
  285.       files, you will enter 'write' menu. the 'write' menu is much like
  286.       'read' menu, but only allow you to change directory.
  287.       The header line in 'read' menu includes "(d:xx,f:xx,t:xx)".
  288.         d : display type. f: number of files. t: number of tagged files.
  289.       pressing SPACE in 'read' menu will let you select which format to use
  290.         for reading current file.
  291.       pressing RETURN in 'read' menu will let you reading current file. This
  292.         program will automatically determine which format this file is.
  293.         The procedure is: First, check magic number. If fail, check
  294.         standard extension. Still fail, report error.
  295.       pressing s or S in 'read' menu will do 'Slide Show'.
  296.         If delay time is 0, program will wait until you hit a key
  297.           (except ESCAPE).
  298.         If any error occurs, program will make a beep.
  299.         'w' or 'W' to pause, any key to continue.
  300.         ESCAPE to terminate.
  301.       pressing b or B to do 'Batch Conversion'.
  302.       pressing Ins in 'read' menu will change display type.
  303.       pressing ALT-X in 'read' menu will quit program without prompting.
  304.       pressing F5 will turn on 'effect' menu.
  305.  
  306.    2. Once image file is successfully read, you will enter 'screen' menu.
  307.       You can do special effect on image.
  308.  
  309.       If you select a movie file, commands are the followings:
  310.         SPACE : pause playing. If you press 'w' or 'W', this program will
  311.           write current frame to file. After writing, screen will pause
  312.           at next frame.
  313.         ESCAPE : Terminate playing.
  314.  
  315.       pressing RETURN: show image.
  316.         in graphic mode, press RETURN, SPACE or ESCAPE to return to text
  317.         mode.
  318.         press '+' and '-' to change screen resolution.
  319.       pressing TAB: change processing target. This program allows you to do
  320.         special effects on 8-bit or 24-bit image.
  321.       pressing Left,Right arrow: change display type. 8, 15, 16, 24 bits.
  322.       pressing SPACE: save current image to file.
  323.         B/W Dither: save as black/white image(1 bit).
  324.         Grey Scale: save as grey image(8 bits).
  325.         Full Color: save as color image(8 bits).
  326.         True Color: save as 24-bit image.
  327.  
  328.         This program will ask you some questions if you want to write image
  329.         to file. Some questions are format-dependent. Finally This program
  330.         will prompt you a filename. If you want to save file under another
  331.         directory other than current directory, please press SPACE. after
  332.         pressing SPACE, you will enter 'write2' menu. You can change
  333.         directory to what you want. Then,
  334.  
  335.         pressing SPACE: this program will prompt you 'original' filename.
  336.         pressing RETURN: this program will prompt you 'selected' filename
  337.                       (filename under bar).
  338.  
  339.  
  340.   3. This program supports 8, 15, 16, 24 bits display.
  341.  
  342.   4. This Program is MEMORY GREEDY. If you don't have enough memory,
  343.      the performance is poor.
  344.  
  345.   5. If you want to save 8 bits image :
  346.        try GIF then TIFF(LZW) then TARGA then Sun Raster then BMP then ...
  347.  
  348.      If you want to save 24 bits image (lossless):
  349.        try TIFF(LZW) or TARGA or ILBM or Sun Raster
  350.        (No one is better for true 24bits image)
  351.  
  352.   6. I recommend Jpeg for storing 24 bits images, even 8 bits images.
  353.  
  354.   7. Not all subroutines are fully tested
  355.  
  356.   8. This document is not well written. If you have any PROBLEM, SUGGESTION,
  357.      COMMENT about this program,
  358.      Please send to u7711501@bicmos.ee.nctu.edu.tw (140.113.11.13).
  359.      I need your suggestions to improve this program.
  360.      (There is NO anonymous ftp on this site)
  361.  
  362.  
  363. (9) Tech. information:
  364.   Program (user interface and some subroutines) written by Jih-Shin Ho.
  365.   Some subroutines are borrowed from XV(2.21) and PBMPLUS(dec 91).
  366.   JPEG is based on the library by Independent JPEG Group.
  367.   Tiff(V3.2) reading/writing are through Tiff library (from ftp.sgi.com).
  368.   DL is based on xdl.c & Xanim260.
  369.   FLI/FLC is based on the article in DDJ (Mar. 1993).
  370.   MPEG is based on Berkeley mpeg_play 2.0.
  371.   AVI is based on Xanim260 by Mark Podlipec.
  372.   Compiled with DJGPP.
  373.   You can get whole DJGPP package from :
  374.     omnigate.clarkson.edu: /pub/msdos/djgpp
  375.  
  376.  
  377. (10) For Thoese who want to modify video driver:
  378.    1. For HiColor and TrueColor, Please reference ET4000.ASM:
  379.  
  380.  
  381. Acknowledgment:
  382.   I would like to thank the authors of XV and PBMPLUS for their permission
  383.     to let me use their subroutines.
  384.   Also I will thank the authors who write Tiff and Jpeg libraries.
  385.   Thank DJ. Without DJGPP I can't do any thing on PC.
  386.   The author would like to thank Olivier Dumas, Ben Jos Walbeehm,
  387.     Bryan Woodworth and other users for their advices and suggestions.
  388.   The author would like to thank NCTUCCCA for offering a place for DISP.
  389.  
  390.  
  391.                                             Jih-Shin Ho
  392.                                    u7711501@bicmos.ee.nctu.edu.tw
  393.